Determines the default volume and default directory.

OSErr PBHGetVolAsync (
    WDPBPtr paramBlock
);

paramBlock

A pointer to a working directory parameter block.

function result

A result code.

DISCUSSION

The relevant fields of the parameter block are:

• ioCompletion

  On input, a pointer to a completion function.

• ioResult

  On output, the result code of the function.

• ioNamePtr

  On output, a pointer to the default volume’s name. You should pass a pointer to a Str31 value if you want that name returned. If you pass NULL, in the field, no volume name is returned.

• ioVRefNum

  On output, a volume reference number or a working directory reference number for the default volume. On exit, the ioVRefNum field contains a working directory reference number (instead of the volume reference number) if, in the last call to PBSetVolAsync or PBHSetVolAsync, a working directory reference number was passed in this field.

• ioWDProcID

  On output, the working directory user identifier.

• ioWDVRefNum

  On output, the volume reference number of the default volume. The volume reference number of the volume on which the default directory exists is returned.

• ioWDDirID

  On output, the directory ID of the default directory.

The PBHGetVolAsync function returns the default volume and directory last set by a call to either PBSetVolAsync or PBHSetVolAsync.

AVAILABILITY

Supported in Carbon. Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

© 2000 Apple Computer, Inc. — (Last Updated 5/8/2000)